Updating Firmware in Windows#

  1. If you have not done so already, follow the steps on the Setup Guide for Windows page.

  2. Download the latest oni-repl Console Application and unzip it. Navigate to this location using a console (e.g. PowerShell).

    Note

    For a complete description of this program, have a look at its usage guide

  3. Verify your PCIe Host Hardware version by running oni-repl and typing “H” into the command prompt. This will print a list of all hubs in the current ONI context, one of which will be the PCIe Host.

    $ oni-repl.exe riffa 0
    ...
    ...
    ...
    >>> H
    
    ../../_images/oni-repl-host-hardware-version.png
  4. Download the latest PCIe Host Firmware for your hardware version.

    Warning

    Make sure that the host firmware image you download matches the PCIe Host Hardware version you verified in the previous step. An incorrect firmware version will not report any error while updating but will cause failures during operation.

  5. Download the PCIe Host Updater utilities package and unzip it. Navigate to this folder using a console.

  6. Run the oni_pcie_mode_change command to put the PCIe host into bootloader mode.

    $ oni_pcie_mode_change.exe
    
    ../../_images/oni-pcie-change-mode-to-bl.png
  7. Open the Windows Device Manager by typing “device manager” into the windows search bar.Find the RIFFA device you are going to update in the device tree. Right click on the RIFFA device and select inactivate.

    ../../_images/device-manager-disable-riffa.png
  8. Right click again and click activate

    ../../_images/device-manager-enable-riffa.png

    Note

    If prompted to do so, or if the device has a small yellow triangle icon next to it, you will need to reboot your computer to finish the process.

  9. Return to the console and run the oni_pcie_flash_image command using the .bin file downloaded in step 4 and the index of the PCIe host device you want to update. If you only have a single PCIe Host board, index can be specified as 0 or omitted.

    $ oni_pcie_flash_image.exe <path to image.bin> [index]
    
    ../../_images/oni-pcie-flash-image.png
  10. When the program completes, run oni_pcie_mode_change to put the PCIe host into normal mode.

    $ oni_pcie_mode_change.exe
    
    ../../_images/oni-pcie-change-mode-to-normal.png
  11. Repeat steps 7 and 8 to reactivate the PCIe Host with the updated firmware.

  12. To verify the firmware update, repeat step 3. The firmware version of the PCIe Host should now match the one downloaded in step 4.